Skip to content

docs: add MiniMax reference-image request example - #131

Open
octo-patch wants to merge 1 commit into
datawhalechina:mainfrom
octo-patch:octo/20260813-image-to-image-tool-recvrXP1ChYfDt
Open

docs: add MiniMax reference-image request example#131
octo-patch wants to merge 1 commit into
datawhalechina:mainfrom
octo-patch:octo/20260813-image-to-image-tool-recvrXP1ChYfDt

Conversation

@octo-patch

Copy link
Copy Markdown
Contributor

Reason: Document the native MiniMax reference-image request and response flow.

  • Add the global and mainland China image generation endpoints.
  • Show the subject_reference object required for character consistency.
  • Document supported models, output handling, completion metadata, and URL expiry.

Checks:

  • npx prettier --check --range-start 21035 --range-end 22435 docs/en/stage-1/integrating-ai-capabilities/index.md
  • git diff --check

Signed-off-by: octo-patch <266937838+octo-patch@users.noreply.github.com>

@linhongyu510 linhongyu510 left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

已按当前 MiniMax 全球站与中国大陆站官方 API 文档逐项复核,可以合并。

确认项:

  • 全球 endpoint https://api.minimax.io/v1/image_generation 与大陆 endpoint https://api.minimaxi.com/v1/image_generation 均正确;
  • image-01image-01-livesubject_reference[].type=characterimage_fileaspect_ratioresponse_formatnprompt_optimizer 均符合当前 schema;
  • character 仅用于人物主体参考的边界说明正确;
  • base_resp.status_codedata.image_urlsmetadata.success_count / failed_count 与官方响应一致;
  • response_format=base64data.image_base64 以及 URL 24 小时有效期的说明与官方文档一致;
  • 直接读取 PR head 后解析新增 curl 的 JSON 成功,字段类型和值均符合示例;MiniMax 代码围栏闭合;
  • 后续引用的 WebP 图片在 PR head 中存在;
  • 关键词和历史 PR 搜索未发现同题竞争实现。

官方依据:

验证边界:没有使用 MiniMax API key 发起计费型真实生成,也没有在本地完整克隆 465MB 以上的图片仓库或运行全站 VitePress 构建。PR head 没有 checks / commit statuses,因此本 Review 证明的是新增 API 文档与官方契约及静态结构一致,不代表端到端生成或整站构建已由 CI 验证。

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants